Copyright: Copyright (c) 1997 Macromedia


Aide sur l'Xtra ActiveX de Macromedia

Pour en savoir plus sur l'Xtra ActiveX, choisissez le produit que vous utilisez :

  Director

  Authorware

Copyright © 1997 Macromedia, Inc. Tous droits réservés. La copie, la photocopie, la reproduction, la traduction ou la conversion en un format imprimé ou électronique, en totalité ou en partie, des informations contenues dans ce système d'aide sont interdites sans l'accord écrit préalable de Macromedia, Inc.


Aide sur l'Xtra ActiveX de Macromedia (Director)

  Vue d'ensemble

 Comment

 Fonctions de rédaction de scripts


Aide sur l'Xtra ActiveX de Macromedia (Authorware)

  Vue d'ensemble

  Comment

 Fonctions de rédaction de scripts


 SOMMAIRE

Vue d’ensemble

L'Xtra ActiveX permet d'utiliser la plupart des contrôles ActiveX d'une animation Director. Avant de commencer, vous devez en savoir plus sur les fonctions de l'Xtra ActiveX :

   Que fait l'Xtra ActiveX ?

   Composants de l'Xtra ActiveX

   Propriétés des contrôles ActiveX

   Méthodes de contrôle ActiveX

   Evénements de contrôle ActiveX


 SOMMAIRE

Vue d’ensemble

The ActiveX Xtra lets you use most ActiveX controls within an Authorware piece. Avant de commencer, vous devez en savoir plus sur les fonctions de l'Xtra ActiveX :

   Que fait l'Xtra ActiveX ?

   Composants de l'Xtra ActiveX

   Propriétés des contrôles ActiveX

   Méthodes de contrôle ActiveX

   Evénements de contrôle ActiveX


 SOMMAIRE

Comment

Les rubriques suivantes fournissent des instructions pour l'utilisation de l'Xtra ActiveX:

   Insertion d'un contôle ActiveX

   Modification des valeurs des propriétés

   Examen des méthodes et des événements

   Téléchargement des contrôles ActiveX depuis une animation Director


 SOMMAIRE

Comment

Les rubriques suivantes fournissent des instructions pour l'utilisation de l'Xtra ActiveX :

   Insertion d'un contôle ActiveX

   Modification des valeurs des propriétés

   Examen des méthodes et des événements

   Téléchargement des contrôles ActiveX depuis un élément Authorware


Que fait l'Xtra ActiveX dans Director?
 SOMMAIRE    [image] VUE D'ENSEMBLE

Que fait l'Xtra ActiveX ?

Servez-vous de l'Xtra ActiveX pour utiliser les contrôles ActiveX dans une animation Director. Les possibilités d’utilisation de l’Xtra ActiveX dans Director sont sans limites grâce au grand nombre de contrôles ActiveX disponibles. Vous pouvez par exemple :

•	explorer l'internet depuis une production multimédia grâce au contrôle Microsoft Web Browser (installé avec Microsoft Internet Explorer 3.0 ou 4.0.)

•	créer des feuilles de calcul et y accéder grâce au contrôle FarPoint Spreadsheet

•	explorer des mondes virtuels grâce au contrôle InterVista VRML

•	construire et simuler des applications Windows complètes dans Director ou Authorware grâce à la bibliothèque MicroHelp étendue des contrôles des éléments Windows

L'Xtra ActiveX fonctionne comme un Xtra image-objet de Director et gère les ressources de l'application pour le contrôle ActiveX hébergé. Cette gestion s'applique aux propriétés, événements et fenêtres, ainsi qu'à l'archivage des propriétés et des ressources utilisées par le contrôle ActiveX dans l'animation Director elle-même.


Que fait l'Xtra ActiveX dans Authorware?
 SOMMAIRE    [image] VUE D'ENSEMBLE

Que fait l'Xtra ActiveX ?

Servez-vous de l'Xtra ActiveX pour utiliser les contrôles ActiveX dans un élément Authorware. Les possibilités d’utilisation de '’Xtra ActiveX dans Director sont sans limites grâce au grand nombre de contrôles ActiveX disponibles. Vous pouvez par exemple :

•	explorer l'internet depuis une production multimédia grâce au contrôle Microsoft Web Browser (installé avec Microsoft Internet Explorer3.0 ou 4.0.)

•	créer des feuilles de calcul et y accéder grâce au contrôle FarPoint Spreadsheet

•	explorer des mondes virtuels grâce au contrôle InterVista VRML

•	construire et simuler des applications Windows complètes dans Director ou Authorware grâce à la bibliothèque MicroHelp étendue des contrôles des éléments Windows

L'Xtra ActiveX fonctionne comme un Xtra image-objet d'Authorware et gère les ressources de l'application pour le contrôle ActiveX hébergé. Cette gestion s'applique aux propriétés, événements et fenêtres, ainsi qu'à l'archivage des propriétés et des ressources utilisées par le contrôle ActiveX dans l'élément Authorware lui-même.


Composants de l'Xtra ActiveX pour Director
 SOMMAIRE    [image] VUE D'ENSEMBLE

Composants de l'Xtra ActiveX

Pour garantir que le composant exécutable est aussi petit que possible pour sa redistribution, l'Xtra ActiveX consiste en deux Xtras MOA :

ActiveX.X32	le composant exécutable

ActXPriv.X32	le composant interface utilisateur

Lorsque vous utilisez Director pour créer un titre interactif, les deux composants doivent être installés dans le répertoire Xtras local de l'application.

Une fois le titre interactif conditionné, ne redistribuez avec lui que le composant exécutable, ActiveX.X32.

Important: Ne redistribuez jamais le composant interface utilisateur, ActXPriv.X32, avec un titre Director conditionné.

Les fichiers mentionnés ci-dessous sont également fournis avec l'Xtra ActiveX. Ce sont des exécutables fournis par Microsoft qui s'installent automatiquement et qui mettent à niveau un système Windows 95 ou Windows NT afin qu'il exécute les composants d'ActiveX. Ils peuvent être appelés par le programme d'installation pour un titre multimédia qui utilise l'Xtra ActiveX.

APRXDIST.EXE	Sous-installateur d'ActiveX pour Win 95/NT 4.0.

AXDIST.EXE	Sous-installateur d'ActiveX pour Win 95/NT 4.0.

WINDIST.EXE	Sous-installateur d'ActiveX pour Win 95/NT 4.0.


Composants de l'Xtra ActiveX pour Authorware
 SOMMAIRE    [image] VUE D'ENSEMBLE

Composants de l'Xtra ActiveX

Pour garantir que le composant exécutable est aussi petit que possible pour sa redistribution, l'Xtra ActiveX consiste en deux Xtras MOA :

ActiveX.X32	le composant exécutable

ActXPriv.X32	le composant interface utilisateur

Lorsque vous utilisez Authorware pour créer un titre interactif, les deux composants doivent être installés dans le répertoire Xtras local de l'application.

Une fois le titre interactif conditionné, ne redistribuez avec lui que le composant exécutable, ActiveX.X32.

Important: Ne redistribuez jamais le composant interface utilisateur, ActXPriv.X32, avec un titre Authorware conditionné.

Les fichiers mentionnés ci-dessous sont également fournis avec l'Xtra ActiveX. Ce sont des exécutables fournis par Microsoft qui s'installent automatiquement et qui mettent à niveau un système Windows 95 ou Windows NT afin qu'il exécute les composants d'ActiveX. Ils peuvent être appelés par le programme d'installation pour un titre multimédia qui utilise l'Xtra ActiveX.

APRXDIST.EXE	Sous-installateur d'ActiveX pour Win 95/NT 4.0.

AXDIST.EXE	Sous-installateur d'ActiveX pour Win 95/NT 4.0.

WINDIST.EXE	Sous-installateur d'ActiveX pour Win 95/NT 4.0.


Propriétés des contrôles ActiveX dans Director
 SOMMAIRE    [image] VUE D'ENSEMBLE

Propriétés des contrôles ActiveX

Un contrôle ActiveX décrit ses informations à l’aide de propriétés (appelées caractéristiques ou valeurs), telles que couleur, texte, police, etc. Les propriétés peuvent inclure non seulement des aspects visuels mais aussi des aspects comportementaux. Un bouton peut par exemple posséder une propriété qui indique s'il s'agit d'un bouton-poussoir (il peut être enfoncé ou non).

Les propriétés d'un contrôle ActiveX en définissent l'état ; certaines ou toutes peuvent être persistantes. Bien que le contrôle puisse changer ses propres propriétés, il est également possible que le contenant du contrôle puisse changer une propriété, provoquant ainsi une modification de l’état, de l’interface utilisateur, etc. du contrôle).

Lorsqu'un contrôle ActiveX est inséré dans une animation Director ou un élément Authorware, vous pouvez visualiser et modifier les propriétés qu'il expose en sélectionnant l'onglet Properties de la boîte de dialogue Control Properties pour l'Xtra ActiveX.

L'Xtra ActiveX liste chaque propriété exportée par le contrôle ActiveX ainsi que sa valeur courante. Vous pouvez modifier la valeur d'une propriété en cliquant sur la valeur existante avec la souris. Pour la plupart des propriétés, telles que les valeurs numériques ou de chaînes, vous pouvez entre la valeur directement au clavier.

Toutes les méthodes exportées par un contrôle ActiveX le sont automatiquement par l'Xtra ActiveX en tant que propriétés de l'Xtra image-objet correspondant.

La syntaxe Lingo générique de définition des propriétés d’un contrôle ActiveX est :

set the NomDePropriété of sprite X to Valeur

La syntaxe Lingo générique d’obtention des propriétés d’un contrôle ActiveX est :

put the NomDePropriété of sprite X into Valeur

Par exemple, si le contrôle Microsoft Access Calendar est inséré dans l’animation Director comme seconde image-objet du scénario, le code Lingo suivant donne à la propriété Year du contrôle Calendar une année spécifique :

set the Year of sprite 2 to 1995

Pour obtenir la propriété Year depuis le même contrôle Calendar et la placer dans une variable Lingo appelée AnnéeCalendaire, le code Lingo suivant est utilisé :

put the Year of sprite 2 into AnnéeCalendaire

Certaines propriétés des contrôles ActiveX sont en lecture seule. Dans ce cas, une tentative de définition d'une propriété pour un tel contrôle provoque une erreur dans Director.


Propriétés des contrôles ActiveX dans Authorware
 SOMMAIRE    [image] VUE D'ENSEMBLE

Propriétés des contrôles ActiveX

Un contrôle ActiveX décrit ses informations à l’aide de propriétés (appelées caractéristiques ou valeurs), telles que couleur, texte, police, etc. Les propriétés peuvent inclure non seulement des aspects visuels mais aussi des aspects comportementaux. Un bouton peut par exemple posséder une propriété qui indique s'il s'agit d'un bouton-poussoir (il peut être enfoncé ou non).

Les propriétés d'un contrôle ActiveX en définissent l'état ; certaines ou toutes peuvent être persistantes. Bien que le contrôle puisse changer ses propres propriétés, il est également possible que le contenant du contrôle puisse changer une propriété, provoquant ainsi une modification de l’état, de l’interface, etc. du contrôle.

Lorsqu'un contrôle ActiveX est inséré dans une animation Director ou un élément Authorware, vous pouvez visualiser et modifier les propriétés qu'il expose en sélectionnant l'onglet Properties de la boîte de dialogue Control Properties pour l'Xtra ActiveX.

L'Xtra ActiveX liste chaque propriété exportée par le contrôle ActiveX ainsi que sa valeur courante. Vous pouvez modifier la valeur d'une propriété en cliquant sur la valeur existante avec la souris. Pour la plupart des propriétés, telles que les valeurs numériques ou de chaînes, vous pouvez entre la valeur directement au clavier.

Pour Authorware, toutes les méthodes exportées par un contrôle ActiveX le sont automatiquement par l'Xtra ActiveX en tant que propriétés de l'Xtra image-objet correspondant.

La syntaxe du langage Authorware calc générique pour la définition de la propriété d'un contrôle ActiveX est :

 SetSpriteProperty (@"Titre de l'icône", #NomProp, Valeur)

La syntaxe du langage Authorware calc générique pour l'obtention de la propriété d'un contrôle ActiveX est :

 Value =GetSpriteProperty ( @"Titre de l'icône", #NomProp)

Par exemple, si le contrôle Calendar de Microsoft Access est inséré dans un Xtra image-objet dans un élément Authorware avec le titre "Calendar", l'instruction suivante en langage Authorware calc donne à la propriété Year du contrôle Calendar une année spécifique :

 SetSpriteProperty (@"Calendar", #Year, 1996 )

Pour obtenir la propriété Year depuis le même contrôle Calendar et la placer dans une variable Authorware appelée AnnéeCalendaire, vous pouvez utiliser l'instruction en langage calc suivante :

 AnnéeCalendaire =GetSpriteProperty ( @"Calendar", #Year )

Certaines propriétés des contrôles ActiveX sont en lecture seule. Dans ce cas, il est interdit de définir une propriété en lecture seule.


Méthodes de contrôle ActiveX dans Director
 SOMMAIRE    [image] VUE D'ENSEMBLE

Méthodes de contrôle ActiveX

Un contrôle ActiveX décrit sa fonctionnalité à l’aide de méthodes. Les méthodes sont des fonctions mises en oeuvre dans le contrôle et qui peuvent être appelées depuis Director pour effectuer une action. Par exemple, une modification ou un contrôle orienté texte prend en charge des méthodes permettant à Director de récupérer et de modifier le texte actuel et éventuellement d’effectuer des opérations de copier-coller.

Lorsqu'un contrôle est inséré dans une animation Director, vous pouvez visualiser les méthodes exposées par le contrôle en sélectionnant l'onglet Methods de la boîte de dialogue Control Properties pour l'Xtra ActiveX. L'Xtra ActiveX liste chaque méthode exportée par le contrôle ActiveX ainsi qu'une description de ses paramètres.

Toutes les méthodes exportées par un contrôle ActiveX le sont automatiquement par l'Xtra ActiveX en tant que fonctions pour l'Xtra image-objet correspondant.

La syntaxe Lingo générique d’appel d’un contrôle ActiveX est :

 put NomDeMéthode (sprite N, param1, param2, ... ) into RetValue

Par exemple, si le contrôle Microsoft Access Calendar est inséré dans une animation Director comme deuxième image-objet dans le scénario, le code Lingo suivant augmenterait l’année affichée dans le contrôle Calendar :

 NextYear (sprite 2)

Pour le même contrôle Calendar, le code Lingo suivant diminuerait l’année affichée dans le contrôle Calendar :

 PrevYear (sprite 2)

Les paramètres passés au contrôle ActiveX sont automatiquement convertis de leurs types de données Director aux types de données ActiveX équivalents par l'Xtra ActiveX. La valeur renvoyée est automatiquement convertie du type de données ActiveX au type de données Director équivalent.


Méthodes de contrôle ActiveX dans Authorware
 SOMMAIRE    [image] VUE D'ENSEMBLE

Méthodes de contrôle ActiveX

Un contrôle ActiveX décrit sa fonctionnalité à l’aide de méthodes. Les méthodes sont des fonctions mises en oeuvre dans le contrôle et qui peuvent être appelées depuis Authorware pour effectuer une action. Par exemple, une modification ou un contrôle orienté texte prend en charge des méthodes permettant à Authorware de récupérer et de modifier le texte actuel et éventuellement d’effectuer des opérations de copier-coller.

Lorsqu'un contrôle est inséré dans un élément Authorware, vous pouvez visualiser les méthodes exposées par le contrôle en sélectionnant l'onglet Methods de la boîte de dialogue Control Properties pour l'Xtra ActiveX. L'Xtra ActiveX liste chaque méthode exportée par le contrôle ActiveX ainsi qu'une description de ses paramètres.

Toutes les méthodes exportées par un contrôle ActiveX le sont automatiquement par l'Xtra ActiveX en tant que fonctions calc pour l'Xtra image-objet correspondant.

La syntaxe du langage Authorware calc générique pour l'appel d'une méthode de contrôle ActiveX est :

 RetValue = CallSprite( @"Nom de l'icône", #NomMéthode, param1, param2, ... )

Par exemple, si le contrôle Calendar de Microsoft Access est inséré en tant qu'Xtra image-objet dans un élément Authorware avec le titre "Calendar", l'appel de la fonction Authorware calc suivante sur l'Xtra image-objet augmenterait l'année affichée dans le contrôle Calendar :

 CallSprite (@"Calendar", #NextYear )

Pour le même contrôle Calendar, l'appel de la fonction Authorware calc suivante sur l'Xtra image-objet diminuerait l'année affichée dans le contrôle Calendar :

 CallSprite (@"Calendar", #PrevYear )

Les paramètres passés au contrôle ActiveX sont convertis de leurs types de données Authorware au type de données ActiveX équivalent par l'Xtra ActiveX. La valeur renvoyée est automatiquement convertie du type de données ActiveX au type de données Authorware équivalent.


Evénements de contrôle ActiveX dans Director
 SOMMAIRE    [image] VUE D'ENSEMBLE

Evénements de contrôle ActiveX

Chaque contrôle ActiveX génère typiquement différents événements. Par exemple, un contrôle ActiveX bouton peut générer un événement click lorsque l’utilisateur clique sur le bouton et un contrôle ActiveX de calendrier pourrait générer un événement dateChanged lorsque la date est modifiée dans le calendrier. L'Xtra ActiveX convertit automatiquement tout événement généré par le contrôle ActiveX en un événement Xtra image-objet que Director peut traiter.

Lorsqu'un contrôle est inséré dans une animation Director, vous pouvez visualiser les événements exposés par le contrôle en sélectionnant l'onglet Events de la boîte de dialogue Control Properties pour l'Xtra ActiveX. L'Xtra ActiveX liste chaque méthode exportée par le contrôle ActiveX ainsi qu'une description de ses paramètres.

Pour que Director réponde à un événement généré par le contrôle ActiveX, vous devez créer un gestionnaire d'événement Lingo pour capturer cet événement. Ces gestionnaires d'événements peuvent être placés dans des scripts d'animations, d'images-objets, de distributions ou d'images. Toutefois, le gestionnaire est normalement placé dans le script de l'image-objet qui représente le contrôle ActiveX dans le scénario.

Par exemple, si le contrôle Microsoft Access Calendar est inséré dans une animation Director comme image-objet du scénario, le code Lingo suivant capturerait l’événement click du contrôle Calendar :

on click

-- Faites quelque chose d’intéressant ici.

     beep 2

end


Evénements de contrôle ActiveX dans Authorware
 SOMMAIRE    [image] VUE D'ENSEMBLE

Evénements de contrôle ActiveX

Chaque contrôle ActiveX génère typiquement différents événements. Par exemple, un contrôle ActiveX bouton peut générer un événement click lorsque l’utilisateur clique sur le bouton et un contrôle ActiveX de calendrier pourrait générer un événement dateChanged lorsque la date est modifiée dans le calendrier. L'Xtra ActiveX convertit automatiquement tout événement généré par le contrôle ActiveX en un événement Xtra image-objet qu'Authorware peut traiter.

Lorsqu'un contrôle est inséré dans un élément Authorware, vous pouvez visualiser les événements exposées par le contrôle en sélectionnant l'onglet Events de la boîte de dialogue Control Properties pour l'Xtra ActiveX. L'Xtra ActiveX liste chaque méthode exportée par le contrôle ActiveX ainsi qu'une description de ses paramètres.

Pour qu'Authorware réponde à un événement généré par le contrôle ActiveX, vous devez créer un symbole de type de réponse à un événement dans Authorware.

Pour définir un symbole de type de réponse à un événement :

1	Définissez une icône d'interaction si ce n'est déjà fait.

Consultez la documentation Authorware concernant la définition d'une icône d'interaction.

2	Faites glisser une icône à0droite de l'icône d'interaction.

L'icône détermine ce qui se passe lorsqu'un utilisateur clique sur le bouton que vous définissez.

Si vous n'avez pas prévu en détail ce qui doit arriver, utilisez une icône carte, qui est le type le plus facile à modifier. La boîte de dialogue Response Type apparaît automatiquement dès que vous libérez l'icône si c'est la première que vous avez ajoutée à l'interaction. Si ce n'est pas la première, Authorware n'affiche pas la boîte de dialogue car il suppose que vous voulez utiliser le symbole de type de réponse choisi en dernier. Si la boîte de dialogue Response Type n'apparaît pas automatiquement, faites un Contrôle-double-clic ou une Commande-double-clic sur le symbole de type de réponse pour l'afficher.

3	Sélectionnez Event, puis cliquez sur OK. Le symbole de type de réponse sur la ligne de traitement de l'interaction se transforme en symbole d'événement.

4	Donnez un nom à l'icône de résultat.

Pour sélectionner le ou les événements devant être reconnus par le symbole de type d'événement comme étant sa réponse cible :

1	Double-cliquez sur le symbole de type de réponse à un événement.

La Boîte de dialogue Event response properties apparaît. Vérifiez que la carte d'événement est actuellement active. Les noms de tous les Xtras images-objets qui existent dans l'élément Authorware apparaissent dans la liste Sender.

2	Double-cliquez sur l'icône de l'Xtra image-objet pour lequel répondre aux événements.

Un x apparaît à gauche du nom de l'Xtra image-objet pour indiquer qu'il a été sélectionné. Vous pouvez sélectionner plusieurs Xtras images-objets. Tous les événements générés par les Xtras images-objets sélectionnés apparaissent dans la liste Event Name.

3	Dans la liste Event Name, double-cliquez sur le nom du ou des événements auxquels répondre.

Un x apparaît à gauche du nom de l'événement pour indiquer qu'il a été sélectionné. Vous pouvez sélectionner plusieurs noms d'événements. Des instructions sur l'utilisation suggérée de l'événement actuellement sélectionné peuvent apparaître dans le champ Description sous la liste Event Name.

4	Effectuez le paramétrage désiré pour la carte de réponse, puis cliquez sur OK.


Insertion d'un contôle ActiveX dans Director
 SOMMAIRE    [image] HOW TO

Insertion d’un contrôle ActiveX

Avec l'Xtra ActiveX (un type d'Xtra image-objet), vous pouvez placer les contrôles ActiveX (précédemment appelés contrôles OLE/OCX) dans une animation Director. Une fois inséré, le contrôle ActiveX fonctionne comme un Xtra image-objet.

Pour insérer un contrôle ActiveX sur la scène :

1	Assurez-vous que les contrôles ActiveX à utiliser dans Director sont installés sur votre système.

La plupart des contrôles disposent de leurs propres utilitaires d’installation fournis par leurs fabricants. Vous pouvez aussi télécharger et installer une large gamme d'exemples de contrôles depuis la Microsoft ActiveX Gallery à http://www.microsoft.com/activex/gallery au moyen d'Internet Explorer 3.0 ou 4.0.

 Cliquez ici pour aller à la Microsoft ActiveX Gallery maintenant.

2 	Choisissez Control dans le menu Insert. Le sous-menu Control apparaît.

3 	Choisissez ActiveX dans le sous-menu Control.

La boîte de dialogue Select ActiveX Control apparaît.

4 	Sélectionnez le contrôle ActiveX désiré puis cliquez sur OK.

La boîte de dialogue ActiveX Control Properties apparaît

Si le contrôle ActiveX n'apparaît pas dans la liste, il se peut que le système n'ait pas installé le contrôle correctement. Vous pouvez vérifier sa présence en consultant la liste des contrôles ActiveX dans une autre application telle que Visual Basic).

5 	Donnez des valeurs à chaque propriété du contrôle ActiveX et cliquez sur OK.

Le contrôle ActiveX apparaît maintenant dans la distribution. Outre la modification de chaque propriété du contrôle ActiveX dans la boîte de dialogue ActiveX Control Properties, vous pouvez visualiser les informations concernant chaque méthode prise en charge par le contrôle et chaque événement que le contrôle peut générer. Voir les rubriques suivantes pour de plus amples informations :

  Modification des valeurs des propriétés

  Examen des méthodes et des événements

6 	Faites glisser le contrôle ActiveX de la distribution vers la scène.

Une fois que le contrôle ActiveX apparaît sur la scène, il peut être positionné et redimensionné tout comme n’importe quel autre Xtra image-objet. Pendant que l'animation est arrêtée, le contrôle ActiveX reste en mode auteur et ne réagit pas aux événements de souris ou de clavier. Lorsque l'animation est lue, le contrôle répond aux actions de l'utilisateur.


Insertion d'un contôle ActiveX dans Authorware
 SOMMAIRE    [image] HOW TO

Insertion d’un contrôle ActiveX

Avec l'Xtra ActiveX (un type d'Xtra image-objet), vous pouvez placer des contrôles ActiveX (précédemment appelés contrôles OLE/OCX) dans un élément Authorware. Une fois inséré, le contrôle ActiveX fonctionne comme un Xtra image-objet.

Pour insérer un contrôle ActiveX dans la ligne de traitement :

1	Assurez-vous que les contrôles ActiveX à utiliser dans Authorware sont installés sur votre système.

La plupart des contrôles disposent de leurs propres utilitaires d’installation fournis par leurs fabricants. Vous pouvez aussi télécharger et installer une large gamme d'exemples de contrôles depuis la Microsoft ActiveX Gallery à http://www.microsoft.com/activex/gallery au moyen d'Internet Explorer 3.0 ou 4.0.

 Cliquez ici pour aller à la Microsoft ActiveX Gallery maintenant.

2	Depuis Authorware, placez le pointeur de la ligne de traitement à l'endroit où insérer l'Xtra image-objet.

3	Choisissez Control dans le menu Insert.

Le sous-menu Control apparaît.

4 	Choisissez ActiveX dans le sous-menu Control.

La boîte de dialogue Select ActiveX Control apparaît.

5 	Sélectionnez le contrôle ActiveX désiré puis cliquez sur OK.

La boîte de dialogue ActiveX Control Properties apparaît

Si le contrôle ActiveX n'apparaît pas dans la liste, il se peut que le système n'ait pas installé le contrôle correctement. Vous pouvez vérifier sa présence en consultant la liste des contrôles ActiveX dans une autre application telle que Visual Basic).

6 	Donnez des valeurs à chaque propriété du contrôle ActiveX et cliquez sur OK.

Le contrôle ActiveX sélectionné est contenu dans l'icône de l'Xtra image-objet qui est insérée dans la ligne de traitement. L'icône est automatiquement nommeée 'ActiveX.' Outre la modification de chaque propriété du contrôle ActiveX dans la boîte de dialogue ActiveX Control Properties, vous pouvez visualiser les informations concernant chaque méthode prise en charge par le contrôle et chaque événement que le contrôle peut générer. Voir les rubriques suivantes pour de plus amples informations :

  Modification des valeurs des propriétés

  Examen des méthodes et des événements

7	Placez des icônes supplémentaires dans la ligne de traitement ; réarrangez-les comme désiré. Continuez à développer votre élément Authorware comme d'habitude.

Un symbole de type de réponse à un événement peut être défini pour répondre aux événements générés par le contrôle.


Modification des valeurs des propriétés dans Director
 SOMMAIRE    [image] HOW TO

Modification des valeurs des propriétés

Vous pouvez modifier les valeurs des propriétés des contrôles au moyen des propriétés ActiveX. Pour de plus amples informations sur les propriétés, voir :

Propriétés des contrôles ActiveX.

Pour modifier les valeurs des propriétés des contrôles :

1	Choisissez le contrôle à modifier dans la boîte de dialogue Select ActiveX Control, puis cliquez sur OK.

La boîte de dialogue ActiveX Control Properties apparaît

2	Cliquez sur la propriété dont vous voulez changer la valeur.

La valeur apparaît en haut de la liste.

3	Modifiez la valeur de la propriété au moyen d'une des méthodes suivantes :

-	Entrez une nouvelle valeur dans la case de modification.

-	Choisissez une valeur dans la liste déroulante.

-	Cliquez sur le bouton points de suspension, [image], pour afficher et modifier les paramètres Custom.

4	Choisissez la propriété suivante à modifier ou cliquez sur OK pour enregistrer vos modifications.

Vos modifications sont enregistrées lorsque vous cliquez sur une nouvelle propriété.


Modification des valeurs des propriétés dans Authorware
 SOMMAIRE    [image] HOW TO

Modification des valeurs des propriétés

Vous pouvez modifier les valeurs des propriétés des contrôles au moyen des propriétés ActiveX. Pour de plus amples informations sur les propriétés, voir :

Propriétés des contrôles ActiveX.

Pour modifier les valeurs des propriétés des contrôles :

1	Choisissez le contrôle à modifier dans la boîte de dialogue Select ActiveX Control, puis cliquez sur OK.

La boîte de dialogue ActiveX Control Properties apparaît

2	Cliquez sur la propriété dont vous voulez changer la valeur.

La valeur apparaît en haut de la liste.

3	Modifiez la valeur de la propriété au moyen d'une des méthodes suivantes :

-	Entrez une nouvelle valeur dans la case de modification.

-	Choisissez une valeur dans la liste déroulante.

-	Cliquez sur le bouton points de suspension, [image], pour afficher et modifier les paramètres Custom.

4	Choisissez la propriété suivante à modifier ou cliquez sur OK pour enregistrer vos modifications.

Vos modifications sont enregistrées lorsque vous cliquez sur une nouvelle propriété.


Examen des méthodes et des événements dans Director
 SOMMAIRE    [image] HOW TO

Examen des méthodes et des événements

Vous pouvez examiner les méthodes et les événements associés aux contrôles ActiveX. Ceci est utile lorsque vous utilisez un contrôle qui n'est pas documenté.

Voir également
Méthodes de contrôle ActiveX
Evénements de contrôle ActiveX

Pour examiner les méthodes ou les contrôles ActiveX :

1	Choisissez le contrôle à modifier dans la boîte de dialogue Select ActiveX Control, puis cliquez sur OK.

La boîte de dialogue ActiveX Control Properties apparaît

2	Cliquez sur l'onglet Methods ou Events.

La boîte de dialogue ActiveX Control Methods ou la boîte de dialogue ActiveX Control Events apparaît selon votre choix.

3	Cliquez sur une méthode ou un événement de la liste.

Une description apparaît en haut de la liste.

4	Cliquez sur OK lorsque vous avez fini d'examiner les méthodes ou les événements.


Examen des méthodes et des événements dans Authorware
 SOMMAIRE    [image] HOW TO

Examen des méthodes et des événements

Vous pouvez examiner les méthodes et les événements associés aux contrôles ActiveX. Ceci est utile lorsque vous utilisez un contrôle qui n'est pas documenté.

Voir également
Méthodes de contrôle ActiveX
Evénements de contrôle ActiveX

Pour examiner les méthodes ou les contrôles ActiveX :

1	Choisissez le contrôle à modifier dans la boîte de dialogue Select ActiveX Control, puis cliquez sur OK.

La boîte de dialogue ActiveX Control Properties apparaît

2	Cliquez sur l'onglet Methods ou Events.

La boîte de dialogue ActiveX Control Methods ou la boîte de dialogue ActiveX Control Events apparaît selon votre choix.

3	Cliquez sur une méthode ou un événement de la liste.

Une description apparaît en haut de la liste.

4	Cliquez sur OK lorsque vous avez fini d'examiner les méthodes ou les événements.


Téléchargement des contrôles ActiveX depuis une animation Director
 SOMMAIRE    [image] HOW TO

Téléchargement des contrôles ActiveX depuis une animation Director

Vous pouvez télécharger un contrôle ActiveX dynamiquement depuis une animation Director pendant sa lecture. Lorsque l'utilisateur rencontre la partie de l'animation ou de l'élément qui spécifie un téléchargement, le contrôle est chargé.

Pour télécharger les contrôles dynamiquement :

1	Choisissez le contrôle à télécharger dans la boîte de dialogue Select ActiveX Control, puis cliquez sur OK.

La boîte de dialogue ActiveX Control Properties apparaît

2	Cliquez sur le bouton URL.

La boîte de dialogue ActiveX Control URL appears.

3	Entrez l'URL complet du contrôle à télécharger.

L'URL spécifié doit correspondre exactement à celui du contrôle ActiveX. Sinon, le téléchargement échoue.

4	Pour utiliser la dernière version du contrôle, conservez -1, -1, -1, -1 comme numéro de version par défaut.

Pour télécharger une version plus ancienne du contrôle, entrez son numéro. Le numéro de version doit correspondre exactement à une version. Sinon, le téléchargement échoue.

5	Cliquez sur OK.

Lorsque l'utilisateur rencontre la partie de l'animation ou de l'élément qui spécifie un téléchargement, l'application essaie de récupérer le contrôle. Si l'URL est incorrect ou si le numéro de version du contrôle n'est pas disponible, le téléchargement échoue. Si l'URL et le numéro de version sont corrects, l'application télécharge le contrôle. Le système confirme que l'utilisateur veut installer le contrôle avant de l'utiliser.


Téléchargement des contrôles ActiveX depuis un élément Authorware
 SOMMAIRE    [image] HOW TO

Téléchargement des contrôles ActiveX depuis un élément Authorware

Vous pouvez télécharger un contrôle ActiveX dynamiquement depuis un élément Authorware pendant sa lecture. Lorsque l'utilisateur rencontre la partie de l'animation ou de l'élément qui spécifie un téléchargement, le contrôle est chargé.

Pour télécharger les contrôles dynamiquement :

1	Choisissez le contrôle à télécharger dans la boîte de dialogue Select ActiveX Control, puis cliquez sur OK.

La boîte de dialogue ActiveX Control Properties apparaît

2	Cliquez sur le bouton URL.

La boîte de dialogue ActiveX Control URL apparaît.

3	Entrez l'URL complet du contrôle à télécharger.

L'URL spécifié doit correspondre exactement à celui du contrôle ActiveX. Sinon, le téléchargement échoue.

4	Pour utiliser la dernière version du contrôle, conservez -1, -1, -1, -1 comme numéro de version par défaut.

Pour télécharger une version plus ancienne du contrôle, entrez son numéro. Le numéro de version doit correspondre exactement à une version. Sinon, le téléchargement échoue.

5	Cliquez sur OK.

Lorsque l'utilisateur rencontre la partie de l'animation ou de l'élément qui spécifie un téléchargement, l'application essaie de récupérer le contrôle. Si l'URL est incorrect ou si le numéro de version du contrôle n'est pas disponible, le téléchargement échoue. Si l'URL et le numéro de version sont corrects, l'application télécharge le contrôle. Le système confirme que l'utilisateur veut installer le contrôle avant de l'utiliser.


Boîte de dialogue Select ActiveX Control

La boîte de dialogue Select ActiveX Control permet de sélectionner et d'insérer un contrôle.

List	Affiche les contrôles ActiveX installés sur votre système.

Search	Permet de faire défiler jusqu'à un contrôle installé. Entrez le nom du contrôle, puis appuyez sur Entrée. La première occurrence du nom est mise en surbrillance. Un nouvel appui sur Entrée affiche l'occurrence suivante du nom.

OK	Insère le contrôle sélectionné et ferme la boîte de dialogue.

Cancel	Ferme la boîte de dialogue sans insérer le contrôle sélectionné.

Help	Affiche l'aide pour la boîte de dialogue.


Boîte de dialogue ActiveX Control Properties

La boîte de dialogue ActiveX Control Properties permet d'examiner et de modifier les valeurs des propriétés d'un contrôle.

Onglet Methods	Affiche la boîte de dialogue ActiveX Control Methods.

Onglet Events	Affiche la boîte de dialogue ActiveX Control Events.

Case Edit	Permet de modifier la valeur de propriété en surbrillance. Vos modifications sont enregistrées lorsque vous cliquez sur une propriété différente.

Vous pouvez modifier la valeur de la propriété grâce à l'une des méthodes suivantes :

Entrez une nouvelle valeur dans la case de modification.

•	Choisissez une valeur dans la liste déroulante.

•	Cliquez sur le bouton points de suspension, [image], pour afficher et modifier les paramètres personnalisés.

List	Affiche les propriétés du contrôle.

Select	Permet de sélectionner un contrôle différent.

OK	Enregistre vos modifications et ferme la boîte de dialogue.

Cancel	Ferme la boîte de dialogue sans enregistrer vos modifications.

URL	Affiche la boîte de dialogue ActiveX Control URL.

Custom	Affiche une boîte de dialogue indiquant les propriétés personnalisées du contrôle. Certains contrôles peuvent ne pas offrir cette fonction.

About	Affiche des informations sur le contrôle. Certains contrôles peuvent ne pas offrir cette fonction.

Help	Affiche l'aide pour la boîte de dialogue.


Boîte de dialogue ActiveX Control Methods

La boîte de dialogue ActiveX Control Methods permet d'examiner les méthodes de contrôle.

Onglet Properties	Affiche la boîte de dialogue ActiveX Control Properties.

Onglet Events	Affiche la boîte de dialogue ActiveX Control Events.

Case Description	Affiche des informations sur la méthode.

List	Affiche les méthodes de contrôle.

Select	Permet de sélectionner un contrôle différent.

OK	Enregistre vos modifications et ferme la boîte de dialogue.

Cancel	Ferme la boîte de dialogue sans enregistrer vos modifications.

URL	Affiche la boîte de dialogue ActiveX Control URL.

Custom	Affiche une boîte de dialogue indiquant les propriétés personnalisées du contrôle. Certains contrôles peuvent ne pas offrir cette fonction.

About	Affiche des informations sur le contrôle. Certains contrôles peuvent ne pas offrir cette fonction.

Help	Affiche l'aide pour la boîte de dialogue.


Boîte de dialogue ActiveX Control Events

La boîte de dialogue ActiveX Control Events permet d'examiner les événements de contrôle.

Onglet Properties	Affiche la boîte de dialogue ActiveX Control Properties.

Onglet Methods	Affiche la boîte de dialogue ActiveX Control Methods.

Case Description	Affiche des informations sur l'événement.

List	Affiche les événements de contrôle.

Select	Permet de sélectionner un contrôle différent.

OK	Enregistre vos modifications et ferme la boîte de dialogue.

Cancel	Ferme la boîte de dialogue sans enregistrer vos modifications.

URL	Affiche la boîte de dialogue ActiveX Control URL.

Custom	Affiche une boîte de dialogue indiquant les propriétés personnalisées du contrôle. Certains contrôles peuvent ne pas offrir cette fonction.

About	Affiche des informations sur le contrôle. Certains contrôles peuvent ne pas offrir cette fonction.

Help	Affiche l'aide pour la boîte de dialogue.


Boîte de dialogue ActiveX Control URL

La boîte de dialogue ActiveX Control URL permet de spécifier que le téléchargement d'un contrôle ActiveX se produira dynamiquement depuis une animation Director ou un élément Authorware pendant sa lecture. Lorsque l'utilisateur rencontre la partie de l'animation ou de l'élément qui spécifie un téléchargement, le contrôle est chargé.

Download from URL	Entrez l'URL complet du contrôle à télécharger. L'URL spécifié doit correspondre exactement à celui du contrôle ActiveX. Sinon, le téléchargement échoue.

Version to Download	Entrez le numéro de version du contrôle à télécharger. Pour utiliser la dernière version du contrôle, conservez -1, -1, -1, -1 comme numéro de version par défaut. Pour télécharger une version plus ancienne du contrôle, entrez son numéro. Le numéro de version doit correspondre exactement à une version. Sinon, le téléchargement échoue.

CLASSID	Affiche l'ID de classe du contrôle ActiveX. La valeur affichée ici peut être copiée et collée dans les Fonctions de rédaction de scripts d'Xtra ActiveX.

OK	Enregistre les spécification et ferme la boîte de dialogue.

Lorsque l'utilisateur rencontre la partie de l'animation ou de l'élément qui spécifie un téléchargement, l'application essaie de récupérer le contrôle. Si l'URL est incorrect ou si le numéro de version du contrôle n'est pas disponible, le téléchargement échoue. Si l'URL et le numéro de version sont corrects, l'application télécharge le contrôle. Le système confirme que l'utilisateur veut installer le contrôle avant de l'utiliser.

Cancel	Ferme la boîte de dialogue sans enregistrer les spécifications de téléchargement.

Help	Affiche l'aide pour la boîte de dialogue.


Fonctions de rédaction de scripts d'Xtra ActiveX dans Director
 SOMMAIRE

Fonctions de rédaction de scripts d'Xtra ActiveX

L'Xtra ActiveX fournit des informations sur son état et son contrôle de fonctions (telles que sécurité et téléchargement) grâce à un ensemble de fonctions de rédaction de scripts. Ces fonctions peuvent être appelées depuis le Lingo de Director. Elles sont mises en oeuvre en tant que fonctions globales dans un Xtra de script de l'Xtra ActiveX.

Les fonctions globales offertes par l'Xtra ActiveX sont : ActiveXInstalled, ActiveXSecuritySetting, ActiveXDownloadSetting, ActiveXSecurityDialog, ActiveXControlQuery, ActiveXControlDownload, ActiveXControlRegister et ActiveXControlUnregister.

ActiveXInstalled

Syntaxe : ActiveXInstalled

Renvoie -1 si le support d'ActiveX est installé et 0 dans le cas contraire.

Détermine si le support d'ActiveX est actuellement installé sur le système. Si le support d'ActiveX n'est pas installé, le titre multimédia ne doit pas utiliser l'Xtra ActiveX.

ActiveXSecuritySetting

Syntaxe ActiveXSecuritySetting

Renvoie le paramètre de sécurité ActiveX : 'High', 'Medium' ou 'None'.

Ce paramètre est utilisé par le système lorsque les contrôles ActiveX sont téléchargés et installés depuis un URL.

High	Le contrôle ActiveX auquel l'URL fait référence doit comporter une signature numérique valide avant l'installation du contrôle dans le système. Sinon, le téléchargement et l'installation du contrôle échouent et et un avertissement est affiché pour l'utilisateur.

Medium	Il est inutile que le contrôle ActiveX auquel l'URL fait référence comporte une signature numérique valide avant l'installation du contrôle, mais l'utilisateur est averti si la signature manque ou n'est pas valide. Si l'utilisateur décide de ne pas installer le contrôle, le téléchargement et l'installation échouent.

None	Aucune sécurité n'est activée et l'utilisateur ne pas être averti d'un contenu dangereux lorsqu'un contrôle ActiveX est téléchargé et installé sur le système.

ActiveXDownloadSetting

Syntaxe ActiveXDownloadSetting

Renvoie le paramètre de téléchargement d'ActiveX : 'Enabled' ou 'Disabled'. Ce paramètre permet à l'utilisateur de spécifier si le téléchargement du contenu d'ActiveX est permis, quel que soit le niveau de sécurité d'ActiveX.

Enabled	Le téléchargement des contrôles ActiveX depuis un URL est activé.

Disabled	Le téléchargement des contrôles ActiveX depuis un URL est désactivé.

Si un titre multimédia essaie de télécharger et d'installer un contrôle ActiveX lorsque le paramètre de téléchargement est désactivé, un message d'erreur s'affiche, avertissant l'utilisateur qu'il n'était pas possible d'accéder au contrôle.

ActiveXSecurityDialog

Syntaxe : ActiveXSecurityDialog

Affiche une boîte de dialogue permettant à l'utilisateur de définir les paramètres de sécurité ActiveX. Cette boîte de dialogue utilise comme modèle les boîtes de dialogue de sécurité de Microsoft Internet Explorer 3.02.

Comme l'Xtra ActiveX ne permet pas la modification des paramètres de sécurité du système depuis un gestionnaire de script, l'affichage de la boîte de dialogue de sécurité représente le seul moyen de changer dynamiquement ces paramètres dans un titre multimédia. Ne permettre qu'à l'utilisateur demodifier les paramètres de sécurité est basé sur des raisons évidentes.

D'une manière générale, un titre multimédia utilisant des contrôles ActiveX utilise les gestionnaires ActiveXSecuritySetting et ActiveXDownloadSetting pour déterminer les paramètres actuels de sécurité du système. Si les paramètres sont inadéquats pour le titre multimédia, l'utilisateur peut se voir demander de les ajuster en fonction du niveau désiré depuis la boîte de dialogue de sécurité de l'Xtra ActiveX.

ActiveXControlQuery

Syntaxe : ActiveXControlQuery string CLASSID

Renvoie -1 si le contrôle ActiveX est installé et 0 dans le cas contraire. Ce gestionnaire peut servir à déterminer si un contrôle ActiveX est actuellement installé sur le système.

La valeur de CLASSID doit être l'identifiant 64 bits unique au contrôle. Par exemple, les valeurs suivantes sont le CLASSID pour le contrôle Microsoft Calendar :

"{8E27C92B-1264-101C-8A2F-040224009C02}"

ActiveXControlDownload

Syntaxe : ActiveXControlDownload string CLASSID, string URL, integerVER1, integer VER2, integer VER3, integer VER4

Télécharge une version particulière du contrôle ActiveX spécifié depuis un URL. Renvoie -1 si le téléchargement réussit et 0 dans le cas contraire.

La valeur de CLASSID doit être l'identifiant 64 bits unique au contrôle. Par exemple, les valeurs suivantes sont le CLASSID pour le contrôle Microsoft Calendar :

"{8E27C92B-1264-101C-8A2F-040224009C02}"

La valeur d'URL est l'URL depuis lequel télécharger et installer le contrôle ActiveX. Ce peut être également un fichier URL local. Si la valeur est uniquement le nom du fichier d'installation du contrôle, elle doit se trouver dans le chemin de recherche de l'application pour Director ou Authorware.

Les paramètres de version spécifient la version du contrôle à installer, ou bien ils peuvent tous être réglés sur -1 pour utiliser la version la plus récente du contrôle.

ActiveXControlRegister

Syntaxe : ActiveXControlRegister string NOMDEFICHIER

Trouve le fichier du contrôle spécifié dans le chemin de l'application et appelle le point d'entrée de DllRegisterServer. D'une manière générale, ceci installe un contrôle ActiveX à enregistrement automatique. Renvoie -1 si l'installation a réussi et 0 dans le cas contraire.

Comme ce gestionnaire ne télécharge pas un contrôle ActiveX, il n'est pas affecté par les paramètres de sécurité ActiveX.

ActiveXControlUnregister

Syntaxe : ActiveXControlUnregister string FILENAME

Trouve le fichier du contrôle spécifié dans le chemin de l'application et appelle le point d'entrée de DllUnregisterServer. D'une manière générale, ceci désinstalle un contrôle ActiveX à enregistrement automatique. Renvoie -1 si l'installation a réussi et 0 dans le cas contraire.

Comme ce gestionnaire ne télécharge pas un contrôle ActiveX, il n'est pas affecté par les paramètres de sécurité ActiveX.


Fonctions de rédaction de scripts d'Xtra ActiveX dans Authorware
 SOMMAIRE

Fonctions de rédaction de scripts d'Xtra ActiveX

L'Xtra ActiveX fournit des informations sur son état et son contrôle de fonctions (telles que sécurité et téléchargement) grâce à un ensemble de fonctions de rédaction de scripts. Ces fonctions peuvent être appelées depuis les fonctions d'Authorware. Elles sont mises en oeuvre en tant que fonctions globales dans un Xtra de script de l'Xtra ActiveX.

Les fonctions globales offertes par l'Xtra ActiveX sont : ActiveXInstalled, ActiveXSecuritySetting, ActiveXDownloadSetting, ActiveXSecurityDialog, ActiveXControlQuery, ActiveXControlDownload, ActiveXControlRegister et ActiveXControlUnregister.

ActiveXInstalled

Syntaxe ActiveXInstalled

Renvoie -1 si le support d'ActiveX est installé et 0 dans le cas contraire.

Détermine si le support d'ActiveX est actuellement installé sur le système. Si le support d'ActiveX n'est pas installé, le titre multimédia ne doit pas utiliser l'Xtra ActiveX.

ActiveXSecuritySetting

Syntaxe ActiveXSecuritySetting

Renvoie le paramètre de sécurité d'ActiveX : 'High', 'Medium' ou 'None'.

Ce paramètre est utilisé par le système lorsque les contrôles ActiveX sont téléchargés et installés depuis un URL.

High	Le contrôle ActiveX auquel l'URL fait référence doit comporter une signature numérique valide avant l'installation du contrôle dans le système. Sinon, le téléchargement et l'installation du contrôle échouent et et un avertissement est affiché pour l'utilisateur.

Medium	Il est inutile que le contrôle ActiveX auquel l'URL fait référence comporte une signature numérique valide avant l'installation du contrôle, mais l'utilisateur est averti si la signature manque ou n'est pas valide. Si l'utilisateur décide de ne pas installer le contrôle, le téléchargement et l'installation échouent.

None	Aucune sécurité n'est activée et l'utilisateur ne pas être averti d'un contenu dangereux lorsqu'un contrôle ActiveX est téléchargé et installé sur le système.

ActiveXDownloadSetting

Syntaxe : ActiveXDownloadSetting

Renvoie le paramètre de téléchargement d'ActiveX : 'Enabled' oru'Disabled'. Ce paramètre permet à l'utilisateur de spécifier si le téléchargement du contenu d'ActiveX est permis, quel que soit le niveau de sécurité d'ActiveX.

Enabled	Le téléchargement des contrôles ActiveX depuis un URL est activé.

Disabled	Le téléchargement des contrôles ActiveX depuis un URL est désactivé.

Si un titre multimédia essaie de télécharger et d'installer un contrôle ActiveX lorsque le paramètre de téléchargement est désactivé, un message d'erreur s'affiche, avertissant l'utilisateur qu'il n'était pas possible d'accéder au contrôle.

ActiveXSecurityDialog

Syntaxe : ActiveXSecurityDialog

Affiche une boîte de dialogue permettant à l'utilisateur de définir les paramètres de sécurité ActiveX. Cette boîte de dialogue utilise comme modèle les boîtes de dialogue de sécurité de Microsoft Internet Explorer 3.02.

Comme l'Xtra ActiveX ne permet pas la modification des paramètres de sécurité du système depuis un gestionnaire de script, l'affichage de la boîte de dialogue de sécurité représente le seul moyen de changer dynamiquement ces paramètres dans un titre multimédia. Ne permettre qu'à l'utilisateur demodifier les paramètres de sécurité est basé sur des raisons évidentes.

D'une manière générale, un titre multimédia utilisant des contrôles ActiveX utilise les gestionnaires ActiveXSecuritySetting et ActiveXDownloadSetting pour déterminer les paramètres actuels de sécurité du système. Si les paramètres sont inadéquats pour le titre multimédia, l'utilisateur peut se voir demander de les ajuster en fonction du niveau désiré depuis la boîte de dialogue de sécurité de l'Xtra ActiveX.

ActiveXControlQuery

ActiveXControlQuery string CLASSID

Renvoie -1 si le contrôle ActiveX est installé et 0 dans le cas contraire. Ce gestionnaire peut servir à déterminer si un contrôle ActiveX est actuellement installé sur le système.

La valeur de CLASSID doit être l'identifiant 64 bits unique au contrôle. Par exemple, les valeurs suivantes sont le CLASSID pour le contrôle Microsoft Calendar :

"{8E27C92B-1264-101C-8A2F-040224009C02}"

ActiveXControlDownload

Syntaxe ActiveXControlDownload string CLASSID, string URL, integerVER1, integer VER2, integer VER3, integer VER4

Télécharge une version particulière du contrôle ActiveX spécifié depuis un URL. Renvoie -1 si le téléchargement a réussi et 0 dans le cas contraire.

La valeur de CLASSID doit être l'identifiant 64 bits unique au contrôle. Par exemple, les valeurs suivantes sont le CLASSID pour le contrôle Microsoft Calendar :

"{8E27C92B-1264-101C-8A2F-040224009C02}"

La valeur d'URL est l'URL depuis lequel télécharger et installer le contrôle ActiveX. Ce peut être également un fichier URL local. Si la valeur est uniquement le nom du fichier d'installation du contrôle, elle doit se trouver dans le chemin de recherche de l'application pour Director ou Authorware.

Les paramètres de version spécifient la version du contrôle à installer, ou bien ils peuvent tous être réglés sur -1 pour utiliser la version la plus récente du contrôle.

ActiveXControlRegister

Syntaxe  ActiveXControlRegister string FILENAME

Trouve le fichier du contrôle spécifié dans le chemin de l'application et appelle le point d'entrée de DllRegisterServer. D'une manière générale, ceci installe un contrôle ActiveX à enregistrement automatique. Renvoie -1 si l'installation a réussi et 0 dans le cas contraire.

Comme ce gestionnaire ne télécharge pas un contrôle ActiveX, il n'est pas affecté par les paramètres de sécurité ActiveX.

ActiveXControlUnregister

Syntaxe : ActiveXControlUnregister string FILENAME

Trouve le fichier du contrôle spécifié dans le chemin de l'application et appelle le point d'entrée de DllUnregisterServer. D'une manière générale, ceci désinstalle un contrôle ActiveX à enregistrement automatique. Renvoie -1 si l'installation a réussi et 0 dans le cas contraire.

Comme ce gestionnaire ne télécharge pas un contrôle ActiveX, il n'est pas affecté par les paramètres de sécurité ActiveX.


 SOMMAIRE

Fonctions de rédaction de scripts

L'Xtra ActiveX fournit des informations sur son état et son contrôle de fonctions (telles que sécurité et téléchargement) grâce à un ensemble de fonctions de rédaction de scripts. Ces fonctions peuvent être appelées depuis le Lingo de Director ou les fonctions d'Authorware. Elles sont mises en oeuvre en tant que fonctions globales dans un Xtra de script de l'Xtra ActiveX.

Les fonctions globales offertes par l'Xtra ActiveX sont : ActiveXInstalled, ActiveXSecuritySetting, ActiveXDownloadSetting, ActiveXSecurityDialog, ActiveXControlQuery, ActiveXControlDownload, ActiveXControlRegister et ActiveXControlUnregister.

ActiveXInstalled

ActiveXInstalled

Renvoie -1 si le support d'ActiveX est installé et 0 dans le cas contraire.

Détermine si le support d'ActiveX est actuellement installé sur le système. Si le support d'ActiveX n'est pas installé, le titre multimédia ne doit pas utiliser l'Xtra ActiveX.

ActiveXSecuritySetting

Syntaxe  ActiveXSecuritySetting

Renvoie le paramètre de sécurité d'ActiveX : 'High', 'Medium' ou 'None'.

Ce paramètre est utilisé par le système lorsque les contrôles ActiveX sont téléchargés et installés depuis un URL.

High	Le contrôle ActiveX auquel l'URL fait référence doit comporter une signature numérique valide avant l'installation du contrôle dans le système. Sinon, le téléchargement et l'installation du contrôle échouent et et un avertissement est affiché pour l'utilisateur.

Medium	Il est inutile que le contrôle ActiveX auquel l'URL fait référence comporte une signature numérique valide avant l'installation du contrôle, mais l'utilisateur est averti si la signature manque ou n'est pas valide. Si l'utilisateur décide de ne pas installer le contrôle, le téléchargement et l'installation échouent.

None	Aucune sécurité n'est activée et l'utilisateur ne pas être averti d'un contenu dangereux lorsqu'un contrôle ActiveX est téléchargé et installé sur le système.

ActiveXDownloadSetting

ActiveXDownloadSetting

Renvoie le paramètre de téléchargement d'ActiveX : 'Enabled' ou 'Disabled'. Ce paramètre permet à l'utilisateur de spécifier si le téléchargement du contenu d'ActiveX est permis, quel que soit le niveau de sécurité d'ActiveX.

Enabled	Le téléchargement des contrôles ActiveX depuis un URL est activé.

Disabled	Le téléchargement des contrôles ActiveX depuis un URL est désactivé.

Si un titre multimédia essaie de télécharger et d'installer un contrôle ActiveX lorsque le paramètre de téléchargement est désactivé, un message d'erreur s'affiche, avertissant l'utilisateur qu'il n'était pas possible d'accéder au contrôle.

ActiveXSecurityDialog

Syntaxe : ActiveXSecurityDialog

Affiche une boîte de dialogue permettant à l'utilisateur de définir les paramètres de sécurité ActiveX. Cette boîte de dialogue utilise comme modèle les boîtes de dialogue de sécurité de Microsoft Internet Explorer 3.02.

Comme l'Xtra ActiveX ne permet pas la modification des paramètres de sécurité du système depuis un gestionnaire de script, l'affichage de la boîte de dialogue de sécurité représente le seul moyen de changer dynamiquement ces paramètres dans un titre multimédia. Ne permettre qu'à l'utilisateur demodifier les paramètres de sécurité est basé sur des raisons évidentes.

D'une manière générale, un titre multimédia utilisant des contrôles ActiveX utilise les gestionnaires ActiveXSecuritySetting et ActiveXDownloadSetting pour déterminer les paramètres actuels de sécurité du système. Si les paramètres sont inadéquats pour le titre multimédia, l'utilisateur peut se voir demander de les ajuster en fonction du niveau désiré depuis la boîte de dialogue de sécurité de l'Xtra ActiveX.

ActiveXControlQuery

Syntaxe ActiveXControlQuery string CLASSID

Renvoie -1 si le contrôle ActiveX est installé et 0 dans le cas contraire. Ce gestionnaire peut servir à déterminer si un contrôle ActiveX est actuellement installé sur le système.

La valeur de CLASSID doit être l'identifiant 64 bits unique au contrôle. Par exemple, les valeurs suivantes sont le CLASSID pour le contrôle Microsoft Calendar :

"{8E27C92B-1264-101C-8A2F-040224009C02}"

ActiveXControlDownload

Syntaxe : ActiveXControlDownload string CLASSID, string URL, integerVER1, integer VER2, integer VER3, integer VER4

Télécharge une version particulière du contrôle ActiveX spécifié depuis un URL. Renvoie -1 si le téléchargement a réussi et 0 dans le cas contraire.

La valeur de CLASSID doit être l'identifiant 64 bits unique au contrôle. Par exemple, les valeurs suivantes sont le CLASSID pour le contrôle Microsoft Calendar :

"{8E27C92B-1264-101C-8A2F-040224009C02}"

La valeur d'URL est l'URL depuis lequel télécharger et installer le contrôle ActiveX. Ce peut être également un fichier URL local. Si la valeur est uniquement le nom du fichier d'installation du contrôle, elle doit se trouver dans le chemin de recherche de l'application pour Director ou Authorware.

Les paramètres de version spécifient la version du contrôle à installer, ou bien ils peuvent tous être réglés sur -1 pour utiliser la version la plus récente du contrôle.

ActiveXControlRegister

Syntaxe : ActiveXControlRegister string FILENAME

Trouve le fichier du contrôle spécifié dans le chemin de l'application et appelle le point d'entrée de DllRegisterServer. D'une manière générale, ceci installe un contrôle ActiveX à enregistrement automatique. Renvoie -1 si l'installation a réussi et 0 dans le cas contraire.

Comme ce gestionnaire ne télécharge pas un contrôle ActiveX, il n'est pas affecté par les paramètres de sécurité ActiveX.

ActiveXControlUnregister

Syntaxe ActiveXControlUnregister string FILENAME

Trouve le fichier du contrôle spécifié dans le chemin de l'application et appelle le point d'entrée de DllUnregisterServer. D'une manière générale, ceci désinstalle un contrôle ActiveX à enregistrement automatique. Renvoie -1 si l'installation a réussi et 0 dans le cas contraire.

Comme ce gestionnaire ne télécharge pas un contrôle ActiveX, il n'est pas affecté par les paramètres de sécurité ActiveX.